home *** CD-ROM | disk | FTP | other *** search
/ Enter 2005 August / EnterCD 08_2005.iso / dosapps / freedos / doc / keyb / readme.txt < prev   
Encoding:
Text File  |  2003-08-21  |  3.9 KB  |  97 lines
  1. Notes about Prototype 4 of KEYB 2.0 ("TAURUS")
  2. ==============================================
  3.  
  4. This is the prototype 4 to KEYB 2.0 ("taurus") project.
  5.  
  6. Prototypes are functional snapshots of my current work that do not contain 
  7. all the functionality of the future 2.0 project.
  8.  
  9. Prototypes started by replacing little by little xkeyb code. Prototype4 is
  10. fairly mature, and most of the code is completely rewritten (it has small
  11. contributions from xkeyb in the SHIFTs management and some non-resident code,
  12. and some code from Matthias Paul to flush caches before reboot).
  13.  
  14. Prototype 4 does NOT work at all with KEY-style files (as xkeyb and
  15. prototypes 1-3 did). It needs files in a format called KC format. You can
  16. create your own KC files with a compiler tool, also included in the pack. The
  17. compiler uses KEY-style files to create KC files. Later you use KC-style files
  18. with KEYBP4. 
  19.  
  20. WARNING: P4 does NOT do any sanity check. If used with damaged KC files, or
  21. non-KC files may look your PC or cause unstability.
  22.  
  23. Prototype 4 comes with a set of layouts (going beyond the "reduced pack" for
  24. xkeyb) which are pre-compiled, and that you can direcly use. These have been
  25. created and compiled by the kind effort of Henrique Peron, author of the
  26. xkeyb packs.
  27.  
  28. From Prototype4, there are no features to miss from xkeyb (except in the rare
  29. case in which you use the MuX API of xkeyb, which will not be supported), or
  30. to remap SHIFT keys (to be added later, and not quite usual anyway) but for 
  31. the contrary, it comes with a large deal of new features, and specially a 
  32. quite more reduced size (around 1.5KB with standard KC files).
  33.  
  34. It is not yet guaranteed to work on a PC/XT class machine (but it will in 
  35. future releases)
  36.  
  37.  
  38. SOME COMMENTS AND FEATURES
  39. --------------------------
  40.  
  41. * See the Fast Help to know more about KEYB2.
  42.  
  43. * It allows you to choose the degree of int9h management that you want. You
  44. will rarely use full management, unless you create a layout that does not
  45. depend on already loaded KEYB management routines. None is provided. By
  46. default, no management is included. Most work is done through int15h/4Fh
  47.  
  48. * It does not yet support codepage changes, but it will in P5 (for the moment,
  49. at least it doesn't refrain DISPLAY from performing the change).
  50.  
  51. * Source file is a single Pascal file with quite a lot of assembler code,
  52. specially in the resident piece.
  53.  
  54. * The module has an improved module discardation system: most of the unused
  55. code is unloaded to save space. This, jointly with the ussage of compiled
  56. layouts, reduces typical resident size from 3.5Kb (in P3) to 1.5Kb (in P4).
  57.  
  58. * You can remap the decimal char, and you can enable/disable the driver with
  59. Ctrl+Alt+F1 and Ctrl+Alt+F2
  60.  
  61. * You can include in XStrings a greater deal of functionality, specify
  62. scancodes and chars, etc.
  63.  
  64. * Overloading is NOT yet supported. To switch layout, unload and reload
  65. the driver.
  66.  
  67. * Character 8 removes a COMBI
  68.  
  69. * The driver is sensible to APL software (but in /9* mode or above)
  70.  
  71. * You can have localised versions of the program under recompilation. To do so,
  72. rename your message file to .NLS extension, and recompile
  73.  
  74. FOR THE PROGRAMMER
  75. ------------------
  76.  
  77. * New TableLookUp procedure to look in the new tables
  78.  
  79. * There is a single StoreKey procedure, which is supposed to be the common
  80. entry point to drop a key to the buffer (and in AT, it will turn to the very
  81. short int16h/AH=5h)
  82.  
  83. * TranslateScancode is the single procedure for those special keys that need
  84. to change their scancode (Alt+number, Ctrl+numpad, Fn keys, ...)
  85.  
  86. * Alt+NumPad effect now through commands
  87.  
  88. * KEYB command execution can be called from the KEYB API
  89.  
  90. * Tighter code discardation
  91.  
  92. * Information about the KEY file structure: see accompaining documentation and
  93. compiler source header
  94.  
  95. * Information about the KC file structure: see compiler source header
  96.  
  97. * To build KEYB use TP7/BP7, and to build the compiler use BC++ 3.1